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ovggyTgy 

This naertt Guide to Turbo no.*? provides the information that users need to write and 
run. program* under the TurboDOS operating system* It includes an overview of 
operating system features* a discussion at architecture and theory of operation* a 
description of each command* and a definition of each user-callable function* 

A companion document* entitled Configuration Guide to TurboDOS. provides the 
information that OEMs and sophisticated users need to generate various operating 
system configurations and to implement driver modules for various peripheral 
components* 

Principal Features 

TurboDOS is a state-of-the-art operating system designed for use as a superior 
alternative to Digital Research CP/M, MP/M and CP/NET on Z30-based 
microcomputers* Major features at TurboDOS are outlined below: 

CP/M Compatibility- TurboDOS is compatible with Digital Research CP/M Version 
2.2, and can be used as a direct replacement for CP/M on any Z20-based 
microcomputer. Any CP/M application, language processor or programming tool 
should operate under TurboDOS without modification. CP/M BDOS functions and 
direct BIOS calls are fully supported. TurboDOS is also fully media-compatible with 
CP/M. It automatically determines whether a diskette is written in standard CP/M 
format or in TurboDOS format. (TurboDOS format diskettes hold 23% to 35% more 
data, and run very much faster.) The format of a newly-created diskette is 
determined when the diskette is initialized. 

Modular Architecture- TurboDOS consists of a set at "building block" modules 
which may be combined to produce a family of compatible operating systems, 
including single-task, spooling, multi-task and networking. Each functional area of 
the operating system is packaged a separate relocatable module, as is each hardware- 
dependent device driver. Modular architecture makes it much easier to adapt 
TurboDOS to various hardware configurations. OEMs who wish to revise any portion 
of the operating system may purchase TurboDOS source code on a moduie-by-moduie 
basis. 

Improved- Performance. In comparative performance benchmarks, TurboDOS is 
much faster than CP/M in file-oriented applications. Much of this speed advantage is 
accomplished by a sophisticated buffer manager. This module performs multi-level 
buffering of disk I/O, using least-recentiy-used (LRU) buffer assignment and other 
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sophisticated optimizations. Buffering provides a manyfold reduction in the number 
ol physical disk accesses in both sequential and random operations. Additional speed 
is provided by a program load optimizer which scans the allocation map of a program 
file*, determines the sequentially allocated segments of the file (often 16K or more in 
length),, and loads these segments at the maximum transfer rate of the disk 
controller. Another major performance improvement is the elimination of warm-start 
and disk log-on delays. Warm-start is instantaneous in TurboDOS because the 
command interpreter is resident (not transient as in CP/M). Disk log-on is not 
required in TurboDOS because the allocation map for each disk is stored on the disk 
(and need not be repeatedly recreated as in CP/M). Written specifically for the Z80 r 
TurboDOS takes full advantage of the extended instruction repertoire of the ZSO to 
increase speed and reduce memory overhead. Use of Z20 index registers has made it 
practical for the TurboDOS kernel to be fully re-entrant* providing greatly improved 
performance'in spooling and multi-user operations. 

Increased Disk Capacity. TurboDOS lets you store 25% to 35% more data on each 
floppy disk, compared to most CP/M implementations. Most of the increased 
diskette capacity is achieved through the use of larger physical sector sizes on 
diskette. Additional ca p acity is achieved by eliminating reserved "system tracks". 
To provide comparability, standard-format CP/M diskettes are also accomodated by 
TurboDOS. TurboDOS was designed to support large hard disks. It supports hard 
disk drives in excess of 1,000 megabytes without partitioning, and allows random 
access, to files up to 134 megabytes. 

Enhanced Reliability. TurboDOS performs read-after-write verification of ail disk 
update operations. While this kind of verification has long been standard practice on 
large-scale computer systems, it is seldom seen on microcomputer systems. The 
TurboDOS buffer manager makes it possible to perform read-after-write verification 
without degrading performance to an intolerable degree. Whenever errors are 
detected, TurboDOS provides meaningful diagnostic messages and a variety of 
recovery options. In the event of a disk error, for example, TurboDOS diagnoses the 
drive, track and sector-involved, and prompts the operator to choose one of three 
recovery alternatives! (1) retry the disk operation again, (2) accept the error and 
continue processing, or (3) abort the program. TurboDOS does not depend on the 
availability of a particular disk drive, but rather scans automatically to allow system 
start-up from any disk drive. This feature allows normal system operation even if 
the "A" drive fails. 

Simplified Disk Changes. The allocation map for each disk is maintained by 
TurboDOS on the disk itself. Consequently, you can change any disk at any time 
without fear of the disk becoming "read-only" or the data being compromised. 
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TurboOOS senses and automatically adapts to changes of disk format (one- or two- 
sided, single- or double-density, etcj Hassle-free disk changes under TurboOOS make 
low-cost single-disk systems truly practical. 

Print Spooling. TurboOOS includes high-performance automatic print spooling as an 
integral part of the operating system. Up to 16 concurrent printers and up to 16 
separate print queues are supported. 

Additional Capabilities. The command interpreter of TurboOOS accepts strings of 
multiple commands, not just single commands. Its command file processor is much 
more powerful than the "submit" facility of CP/M, and allows multi-level nesting of 
command files. TurboOOS provides an extensive set of utility programs, system date 
and time functions, standard communications channel interface, and numerous other 
capabilities not available in CP/M. 

Multi-User Facilities. Multi-user configurations of TurboOOS provide the file and 
record interlocks necessary to permit simultaneous multi-user access to common data 
bases. Implicit file-level interlocks are completely automatic, require no user- 
program participation, and support multiple inquiry tasks concurrent with one update 
task. Explicit record-level interlocks support concurrent interleaved update by 
multiple tasks. Password-type log-on security prevents unauthorized access and 
protects private file libraries. A log file keeps an automatic record of all system 
usage. 

Networking Facilities. TurboOOS supports a multi-user network of interconnected 
microcomputers which can share a common pool of mass storage, printers and other 
peripherals. Since this approach provides a microcomputer dedicated to each user, 
TurboOOS is able to support a large number of simultaneous users with excellent 
performance. TurboOOS is especially well-suited to the new generation of bus- 
oriented multi-processor microcomputer hardware which is now becoming available. 
Both master-to-master and master-to-siave interconnections are supported. Slave 
processors may have their own local disk storage, or may be entirely down-line loaded 
from a master processor. Networking TurboOOS incorporates an advanced failure 
detection and recovery facility that makes a master-slave network virtually 
crashproof. Even a malicious user running in a slave processor cannot compromise 
the processing or files belonging to another user. 
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Operational Difference* fronr CP/M 

Operation under TurboDOS is similar to CP/M, with the following: significant 

differences* 

1* Program loading and ail file operations are very much faster under TurboOOS. 
Warm-start (when a program returns to the operating system) and disk log-on 
(when a drive is accessed for the first time after a warm-start) are instantaneous 
in TurboOOS. As a result^ you will notice a different operating "rhythm". 

2. The command prompt is of the form "OA}" - (instead of CP/M's "A>") to provide a 
constant reminder that you are using TurboOOS. The number indicates the 
current user number, and the letter indicates the default drive. 

3. In response to a command prompt^ TurboOOS allows you to enter either single 
commands or multi-command strings. Multiple commands must be separated by a 
command separator character, normally backslant The length of a multi¬ 
command string is limited to the size of the command buffer, normally 157 
characters. If you enter a multi-command string, TurboDOS displays each 
command in the string as it is executed. 

AH TurboOOS commands are transient programs (Le^ .COM files). There are no 
"built-in" commands. Each command is described in detail in Section 3 of this 
document. Many of the TurboOOS commands are rather different than the ones 
supported by CP/M. 

5. The TurboDOS "DO" command enables you to execute a previously prepared file 
of commands. This facility works somewhat differently than CP/M's "SUBMIT", 
and permits DO-file nesting to any reasonable depth. See the description at the 
"DO” command for details. 

6. Under TurboOOS, you can stop the execution of a program or DO-file by typing 
the attention character (normally CTRL-S). TurboOOS will "beep" in response to 
such an attention request. After an attention request, you may restart execution 
by typing the restart character (normally CTRL-Q), or abort by typing the abort 
character (normally CTRL-C). 

7. TurboDOS provides a flexible and user-defined facility for loading any program 
(e.g., a function menu) automatically at initial system cold-start and/or at each 
system warm-start. See the description of the "AUTOLOAD" command for 
details. 
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3. Under singie-user TurboDOS, you may safely change disks any time the system is 
awaiting input from the console keyboard* A disk will never become "read-only” 
as the result of a disk change* It is not necessary to type CTRL-C when 
changing disks; in fact,. TurboDOS will ignore CTRL-C in most contexts* Then 
processing under the control of a DO-fiie, you should wait for the DO-file to 
complete before changing disks* When doing concurrent printing, wait for ail 
printing to complete before changing the disk in the de-spool drive* Under multi¬ 
user configurations of TurboDOS, you should enter a "CHANGE” command before 
changing disks, to ensure that no other user is affected by the disk change. 

9. TurboDOS-format diskettes have large sector sizes (512 or 102^ bytes), no skew, 
and no reserved tracks. TurboDOS can also use standard CP/M-format diskettes; 
however* performance and disk capacity are greatly reduced* Therefore* it is a 
good idea to copy programs and data to TurboDOS-format diskettes whenever 
possible* The format cf a diskette is determined when the diskette is initialized, 
and is sensed automatically and dynamically by TurboDOS after any disk change. 


Start-Up P f ngpdurfr 


If your computer has a TurboDOS start-up PROM installed, system start-up is 
accomplished by resetting the processor and inserting a TurboDOS-format disk which 
contains the files OSLOAD.COM and OSMASTER*SYS in any drive. The start-up 
process is automatic. When start-up is complete, a sign-on message is displayed. 

If your computer has a CP/M start-up PROM installed, system start-up is a two-stage 
process. First, you must bring up CP/M in the usual fashion. Then, you must insert 
a CP/M-format disk which contains the files OSLOAD.COM and OSMA5TER*SYS in 
any drive, log-on to that drive, and type "OSLOAD". 
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THBOBY OP OPERATION 


Modular Arrhltagtiir^ 


TurboOOS is packaged as a set of relocatable modules* Each functional area of the 
operating system is packaged a separate module, as is each hardware-dependent 
device driver* As an illustration,, some at the functional modules of TurboOOS ares 


* Local user interface 

. Slave network interface 

* Master network interface 

* Command language interpreter 

* Command file pro c ess o r 
. OS function decode 

* Non-file manager 
. File manager 

. Program load optimizer 

* Memory manager 


* Buffer manager 

* Disk manager 

» Console manager 

* Printer manager 

. Multi-task dispatcher 
. Spooier/despooier 
. Physical console manager 
. Physical printer manager 
. Physical floppy disk manager 

* Physical hard-disk manager 


Many of these modules are optional* The modules are "building blocks" which can be 
combined in various ways to produce a family of compatible operating systems* 
Possible TurboOOS configurations include single-task, spooling, multi-task, real-time, 
time-sharing, distributed-processing, and networking. 

Modular architecture facilitates the adaptation of TurboOOS to various hardware 
configurations. Each hardware-dependent element is a separate relocatable module. 
An easy-to-use system generation utility program is used to link together the desired 
combination of functional and hardware-dependent modules to create a version of 
TurboOOS configured with the desired features and for the desired hardware. 
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CP/M-Compatibl^ Functions. 

TurboDOS function* are invoked by a call to location 5 with a function number in the 
C-register,. in the same fashion a* in CP/M. TurboDOS supports the following CP/M 
functionst 


0 

Return to* O/S 

2a 

Read Next Record 

1 

Input Character from Console 

21 

Write Next Record 

2 

Output Character to Console 

22 

Create File 

3 

Input Character from Reader 

23 

Rename File 

4- 

Output Character to Punch 

24* 

Return Ready Vector 

5 

Output Character to Printer 

23 

Return Default Disk 

6 

Direct Console I/O 

26 

Set Record Buffer Address 

7 

Return I/O Routing 

27* 

Return Disk Allocation Info 

8 

Set I/O Routing 

28 

Set Write-Protect Vector 

9 

Output Buffer to Console 

29 

Return Write-Protect Vector 

10 

Input Buffer from Console 

30 

Set File Attributes 

11 

Return Console Status 

31* 

Return Physical Disk Info 

12 

Return O/S Version 

32 

Set/Retum User Number 

13 

Reset Disk System 

33 

Read Random Record 

14 

Select Default Disk 

34 

Write Random Record 

13 

Open File 

35 

Compute File Size 

16 

Close File 

36 

Set Random Record 

17 

Search for First File 

37 

Reset Write Protect Vector 

18 

Search for Next File 


(38,39 are Reserved) 

19 

Delete File 

40* 

Write Random w/Zero Fill 


These TurboDOS functions are the exact equivalents of the corresponding functions in 
CP/M, except for the four functions marked with an asterisk above. Three of these 
functions (24, 27 and 31) affect only the CP/M "STAT” utility, which is not normally 
used with TurboDOS. Refer to Section 4 for details of the TurboDOS implementation 
of these functions. Function 40 is treated by TurboDOS as a synonym for function 
34. 

TurboDOS also provides a full simulated "BIOS branch table" in order to support 
programs which make direct calls on the CP/M BIOS. This branch table always 
begins 256 bytes from the top of memory in order to ensure that it begins on a page 
boundary (as it does in CP/M). 
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Additional PmirtiQM 

In addition to the CP/M-compatihie functions listed abovey TurboDOS supports more 
than 4a additional functions. These are numbered In the range 64-127 to avoid 
conflict with CP/M and MP/M. They are concerned with real-time clock, 
communications channel support, buffer management, DO-filesy autoload, spooling, 
disk labels, networking, log-on/log-off and other TurboDOS extensions. These 
additional functions are provided primarily to support various TurboDOS commands, 
but they may be invoked by user programs If desired. Refer to Section 5 for a 
detailed description of each function. 

Dlak FormattL 

TurboDOS was designed to accomodate any combination of disk storage units, from 
mini-floppies to large hard disks in excess of 1,000 megabytes. For maximum 
capacity and performance, TurboDOS disks are generally formatted with large sector 
sizes (typically 512 or 1,024 bytes), no skew, and no reserved "system tracks". 
However, TurboDOS is also fully media-compatible with CP/M. It automatically 
determines whether a diskette Is written In standard CP/M format or in TurboDOS 
format. (TurboDOS format diskettes hold 25% to 35% more data, and run very much 
faster.) The format of a newly-created diskette Is determined when the diskette is 
initialized. 

The first portion of any disk is reserved for a file directory. Unlike CP/M, 
TurboDOS maintains a volume label and an allocation map at the beginning of the 
directory area. When a CP/M disk Is first accessed by TurboDOS, the first few 
directory entries are automatically relocated to make room for the label and map. 
When a TurboDOS disk Is accessed by CP/M, the label and map appear to be ordinary 
deleted entries in the directory. 
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Command Un» ProggMiny 

All TurboDOS commands are transient programs (Le., .COM files). There are no 
"built-in" commands. Each command is described in detail in Section 3 of this 
document*. Many of the TurboDOS commands are rather different than the ones 
supported by CP/M* 

The command line interpreter module of TurboDOS accepts either single commands or 
multi-cornmand strings* Multiple commands must be separated by a command 
separator character, normally backslant "\". The length of a multi-command string is 
limited to the size of the command buffer, normally 1 57 characters* When 
processing a multi-command string, TurboDOS displays each individual command on 
the console as it is executed* 

Each TurboDOS command consists of a program file reference followed by an optional 
command tail up to 127 characters long* The program file reference may include an 
explicit file type, but ".COM" is assumed if it doesn't. The command line Interpreter 
loads the program file into the TPA (transient program area of memory starting at 
0100H) and transfers control to it. The command tail length and text are passed in 
the default buffer (starting at 0080H), and up to two file references in the command 
tail are passed in the default FCB (file control block starting at 0Q5CH and Q06CH). 

A file reference identifies a particular file or group of files, and is always given In 
the following format* 


driilename.typ 

where "ds" specifies the drive letter A.~P, and may be omitted if the file is on the 
default drive; "filename" specifies the file name of 8 characters or less; and ".typ" 
specifies the file type of 3 characters or less, prefixed by a period. The character 
"?" may be used in the file name or file type as a "wild-card" to match any character 
in the corresponding position. The character may be used In the file name or file 
type to indicate that ail remaining character positions are wild-cards. Wild-cards are 
especially useful for making reference to a group of files without enumerating each 
one Individually (e.g., in the COPY, DELETE and RENAME commands). 

The command line interpreter is an optional module of TurboDOS, and may be 
omitted in dedicated application-oriented systems. Omitting this module reduces the 
size of the operating system, and prevents the user from escaping from the control of 
the application software. In absence of the command line interpreter, the TurboDOS 
autoload facility must be used to load the first program at system start-up. 
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DQ-Filc Processing 

The DO-file manager module of TurboDOS and the DO command permit automatic 
execution of a pre-defined sequence of TurboDOS commands stored on disk. A DO- 
file is simply an ASCII file of any desired length, each line of which contains any 
valid TurboDOS command or multi-command string. A DO-file may contain any 
number of embedded DO commands, even in multi-command strings. TurboDOS 
supports full nesting of DO-files to any reasonable depth. A DO-file may also 
include any number of parameters which are automatically replaced by the 
corresponding arguments from the tail of the DO command. DO-files can be 
prepared with any conventional text editor. 

Certain commands (such as COPY, RENAME and DELETE) and other programs expect 
interactive input from the console keyboard. If such a command or program is 
executed within a DO-file, then its console input comes from the DO-file rather than 
the keyboard. An exception is console input solicited by means of direct console I/O 
(function 6) or direct calls on the BIOS vector* 

The DO-file manager is an optional module of TurboDOS, and may be omitted in 
dedicated application-oriented systems. Omitting this module reduces the size of the 
operating system. 
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Attention gfigUfiStt. 

Under TurboDOS, the execution of a program or DO-file may be suspended by typing 
the attention character (normally- CTRL-S) at the console keyboard* TurboDOS will 
"beep* to acknowledge receipt of the request. After an attention request, TurboDOS 
will accept one of the following: attention responses? 

Abort (normally CTRL-C) aborts execution of the current program or DO-file, and 
causes any- nested command lines and DO-files to be disregarded* 

Echo-Print (normally CTRL-P) restarts execution, and causes all subsequent 
console output to be echoed to the printer (in addition to being displayed)* A 
second Attention-Echo sequence turns off echoing of console output to the 
printer* ' 

End-Print (normally CTRJL-L) restarts execution after signalling the end of the 
current print job* If printing is being spooled, this causes the current print file 
to be closed and queued for printing* 

Resume (normally CTRL-Q) restarts execution. 
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The concurrent printing faHH-rieg of TurboDOS consist of a '’spooler" and "de-spooler". 
The spooler permits print output to be redirected to disk, creating print files which 
are then queued for printing by the de-spooler. The de-spooler prints from its queue 
of print jobs concurrently with ordinary foreground processing tasks. 

TurboOOS supports up to 16 simultaneous printers (A,B,C^^P) and up to 16 print 
queues (A^3,C,...,P). Various print queues may be used to group together print jobs 
with similar forms requirements and/or priorities. Alternatively, multiple printers 
may be assigned to the same queue to achieve automatic load-sharing. 

The PRINT command controls the routing of print output: 

PRINT D RTVF_=d QUEUBsq causes print output to be spooled to print files on the 
specified drive (d»A^P), then queued automatically on the specified print queue 
(qsA...P) for de-spooied printing. Print files are created automatically, and 
named -PRINT-qJ301, -PRINT-q.002, etc. Print files are dosed at the conclusion 
of each program (Le^ warm-start), by an end-print attention request from the 
console, by an explicit operating system function call, or by the presence of an 
end-of-print character in the print output stream (if EOPCHR is defined). 

print PRiVEad FILE causes print output to be spooled to print files on the 
specified drive (d=A„.P). The print files are not queued automatically for 
printing, but may be queued manually with the QUEUE command. Print files are 
created automatically, and named -PRINT-.001, -PRINT-U302, etc. 

PRINT PRTNTERsp causes print output to be routed directly to the specified 
printer (p=A...P) without intermediate spooling to disk. 

PRINT CONSOLE causes print output to be routed to the console. 

PRINT OFF causes print output to be discarded. 

In a multi-user TurboDOS configuration, each user may control his own print routing 
independently. In a networking configuration, slave processors may route print output 
to a local (slave-owned) or remote (master-owned) printer by using the keywords 
LOCAL or REMOTE in any PRINT command. 
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Dc-Sppoicd Printing 

The PRINTER command controls de-spooied printing? 

PRINTER p qtrgTiEsq- causes the specified printer (p=A.~P) to take its print jobs 
from the specified de-spool queue (q=A^P). If the printer is currently printing: 
from another queue,, then the new assignment takes effect at the end of the 
current print job. 

printer p off causes the specified printer to be taken offline at the end of the 
current print job. An offline printer may be accessed for direct printing. 

PRINTE R p STOP temporarily suspends de-spooling to the specified printer (e.g., 
to correct a paper jam). 

PRINTER p CQ resumes de-spooling- to the specified printer. , 

PRINTER p BECTN stops de-spooling to the specified printer, and causes the 
current print job to be reprinted from the beginning when, de-spooling is resumed. 

printer p TER MINATE terminates the current print job on the specified printer, 
and continues with the next queued job. The terminated print file is not deleted 
from disk, however, so the job may be manually requeued with the QUEUE 
command. 

The spooler and de-spooier are optional modules of TurboOOS, and may be omitted in 
systems where memory space, is at a premium. 
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Log-On and Log-Off 

The LOGON and LOGOFF commands provide password-type security,, the purpose of 
which is to prevent unauthorized access to the system and to protect private file 
libraries. 

The LOGON command prompts for a user-ID to be entered from the console 
keyboard. The user-ID is validated against the file U5ERID.5YS, an ASCII text file 
containing entries of the form: 

userid? (password]? usemoCP], [drivel 

where "userid* and "password” are up to S characters in length? "usemo” is a user 
number 0.«30, and "drive” is a drive letter AThe password and drive fields are 
optional. If the given user-ID has an associated password specified in U5ERID.SYS, 
then LOGON prompts for a password to be entered and validates it. The log-on 
succeeds only if both user-ID and password are valid? in which case the console is 
logged onto the specified user number, and the specified drive is selected as the 
default disk. The user number suffix "P” in a USERID-SYS entry causes the log-on to 
be "privileged”, enabling the user to access various protected facilities of TurboDOS. 

The LOGOFF command sets the user number to a reserved value (normally 31) and 
selects the system drive as the default disk. The library for user 31 on the system 
drive normally contains only LOGON.COM and USERID .SYS flies. Consequently, no 
further activity can be performed until a successful LOGON has been accomplished. 

If the user 31 library also contains a file named SYSLOG.SYS, then the LOGON and 
LOGOFF commands will automatically record in that file a chronological log of all 
log-on and log-off activity. 

If the optional module SGLLOG is included? TurboDOS will not permit more than one 
non-privileged log-on to a particular user number at a time. 
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Automatic Program L oading 

TurboDOS provides a. flexible and user-defined facility for loading any program (e.g. r 
a function menu,, the LOGON command) automatically at Initial system cold-start 
and/or at each system warm-start. Automatic program loading at cold-start and 
warm-start are controlled by files named COLDSTRT.AUT and WARMSTRT.AUT 
respectively. Automatic program loading takes place only if the corresponding .AUT 
file is present cn the logged-on disk. 

The AUTOLOAD command is used to create these .AUT files. Alternatively, a .COM 
file may be automatically loaded simply by renaming it as COLD5TRT.AUT or 
WARMSTRT.AUT. 

The autoload processor is an optional module of TurboDOS, and may be omitted. If 
the autoload module is omitted, then the command line interpreter module must be 
included. 

File Management 

TurboDOS file management is both program and media compatible with CP/M, but it 
relaxes many of the restrictions of CP/M. TurboDOS supports large hard disks in 
excess of 1,000 megabytes (65,536 blocks of 16K bytes each) without partitioning. 
File sizes to 134 megabytes (3,192 extents of 16K bytes each) are allowed for both 
sequential and random access. Random record numbers are supported to 20-bits 
(0.~1,043,575). 

TurboDOS also supports two special pseudo-files. "$.DIR" refers to the directory 
area of a disk, while "$.DSK" refers to the entire contents of a disk volume (up to a 
maximum of 134 megabytes). These pseudo-files may be dumped, patched, or 
accessed like any ordinary file. However, access is restricted to privileged log-ons 
only. 

A third pseudo-file ^.LQK" may be used by any user in connection with shared-file 
record locks (see below). 
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EJJ* Attribute 

Six of the possible eleven file attribute bits (sign bits of the file name/type) in the 
directory are defined in TurboDOS as fallows* 

fi * Exclusive attribute 
£2 s Shared attribute 
f3 s FIFO attribute 
f4-f& s (unassigned) 

tl s Read-only attribute 

t2 s Global attribute ("system file 0 in CP/M) 

t3 s Archived attribute 

These attributes may be set by means of (1) a call to TurboDOS function 30 (set file 
attributes), (2) the SET command, or (3) the normal file renaming facility of many 
high-level language processors. File attributes may be displayed with the SHOW 
command. 

If the exclusive attribute is set, a file may be opened by only one process at a time; 
requests by other processes to open the same file are denied (as if the file could not 
be found). If the read-only attribute is set, a file may not be written, deleted or 
renamed by any process. If the shared attribute is set, a file may be opened, read, 
and written by any number of concurrent processes; shared files are also eligible for 
record locks (described below). If none of these attributes (exclusive, read-only, 
shared) is set, then a file may be opened and read by multiple proc e ss e s concurrently, 
but may be written only by one process. 

If the global attribute is set for a file under user number zero, then that file may be 
accessed from any user number* A global file may be written unless the read-only 
attribute Is also set. The global attribute has no effect for files under non-zero user 
numbers. 

The FIFO attribute indicates that a file is to be accessed using a special first-in- 
first-out access method (described below). 

The archived attribute is set automatically whenever a file is archived by means of 
the COPY command with the ";A" option (see COPY command), and is automatically 
reset whenever a file is written. 
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Settiny PHe Attributes ria Benam* 

To permit file attributes ta be set by programs written in high-level languages,. 
. Turbo DOS includes an extension to its file renaming facility (function 23). If a file is 
renamed^ and if the new name consists solely of the characters V*, and 

space, then the operation is treated by Turbo DOS in a special way. The character 
"+"■ causes the corresponding file attribute to be set, while the character causes 
the attribute to be cleared. Characters and space leave corresponding attributes 
unchanged. For example, the Microsoft BASIC-80 statements 

200 NAME "DATABASEJDAT"* AS 

would have the effect of setting the Shared (£2) and Global (t2) attributes an the file 
DATABASEJbAT. 

Ellft Sharing a«d IpfCgladg 

TurboDOS provides a user number prefix to file names which permits a disk directory 
to contain up to 32 logical sub-directories^. Most file operations (creating, renaming, 
deleting, searching, etc.) are restricted to the sub-directory corresponding to the 
current user number. However, files created under user number zero and given the 
"Global" attribute may be opened under any other user number. This permits 
commands, programs, and other common files to be shared by ail users. 

Multi-user configurations of TurboDOS provide the file and record interlocks 
necessary to permit simultaneous multi-user access to common data bases. Implicit 
file-level interlocks are completely automatic, require no user-program participation, 
and support multiple inquiry tasks concurrent with one update task. Explicit record- 
level interlocks support concurrent interleaved update by multiple tasks. 

The implicit interlocks supported by TurboDOS permit any number of users to read a 
shared file simultaneously. If any user writes to the file, then that user gains an 
exclusive write-lock on the file. Attempts by any other user to write to the same 
file returns an error code. The writing user may extend the file by adding new 
records at the end, and these records become immediately accessible to all sharing 
users. The exclusive write-lock is released when the file is closed or the locking 
program terminates. 


2-12 


U»ftr ( $ Guide to TurboDOS 
Copyright (O 1921 by Software 2000 Inc. 

Theory of Operation 


RwordrUTd Interioda tar Shared FUci 

TurboDOS supports automatic record-level interlocks for files which have the shared 
attribute set* TurboDOS permits full use of its record-level interlocks from existing 
high-level language compilers and interpreters (unlike CP/M-3 and MP/M-2)* A set of 
sample programs w r i tten in Microsoft BASIC-80 is attached to illustrate the manner 
in which record-level interlocks may be used in concurrent update applications* 

Record locks are controlled by means of a pseudo-file named "$*LOK”, which is not a 
real disk-resident file but rather a means for a program to announce its interlocking 
intentions to TurboDOS in a CP/M-compatible fashion* Operations on $*LOK (open, 
create, close, delete^ read, write, etc.) involve no disk work and are essentially 
Instantaneous* 

A process announces its intention to use record-level Interlocks either by opening 
(function 13) or creating (function 22) the pseudo-file $J.OK* Subsequently, if the 
process reads a record from a file which has the shared attribute, then the process 
automatically acquires a lock on that record* Any number of records in any number 
of shared files may be locked concurrently. Similarly, if the process writes a record 
to a shared file, then the process automatically releases any lock that it may have on 
that record. Whenever the process opens, creates, or closes the pseudo-file $.LOK, it 
relinquishes any outstanding record locks that it may have* 

If a process attempts to read or write a record which is locked by someone else, the 
result depends upon whether the process opened or created $.LOK. If the process 
opened $*LOK, then any attempts to read or write a locked record cause the process 
to be suspended until the locked record becomes available. If the process created 
$«LOK, then any attempts to read or write a locked record are immediately denied, 
and an error code is returned (A-reg = 8). 

TurboDOS allows a shared file to be extended in a concurrent update environment 
(unlike CP/M-3 and MP/M-2). The extending program should first acquire an 
interlock by attempting to read past end-of-file (this will return an EOF status, and 
will acquire an interlock on the record at EOF+1). Then, the program may safely 
write a new record to EOF+1. If sparse files are used, this same procedure can be 
used for adding any non-existent record to a random-access file. 
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FTFOa 

To facilitate inter-process and inter-user communications,. TurboDOS supports a 
special kind of file called a "FIFO" - (first-in first-out) which is similar to a "pipe"' 
under UNIX* FIFOs are opened, closed, read and written exactly like ordinary 
sequential files*- However, a record written to a FIFO is always appended to the end, 
and a record read front a FIFO is always taken from the beginning and removed from 
the FIFO* 

A FIFO is differentiated from other files by the presence of the FIFO attribute in the 
directory. Record zero of a FIFO is used by TurboDOS as a special header record to 
keep track of the FIFO. The header record specifies whether the body of the FIFO 
is to be disk-resident or RAM-resident, and the maximum number of records the FIFO 
may contains RAM-resident FIFOs provide high speed but limited capacity (up to 127 
records, usually much less), while disk-resident FIFOs provide large capacity (up to 
65 y335 records) but slower speed. The FIFO command may be used to create a FIFO 
and initialize its header. 

Normally, reading from an empty FIFO returns an end-of-file condition (A * 1), and 
writing to a full FIFO returns a disk-full condition (A - 2). However, reading from 
an empty FIFO or writing to a full FIFO which has the Shared attribute set causes 
the process to be suspended until the FIFO becomes non-empty or non-fuLL 

The header or disk-resident body of a FIFO may be accessed directly by using read- 
random (function 33) and write-random (function 34) operations, thereby bypassing the 
normal first-in first-out protocol. An attempt to create (function 22) an existing 
FIFO is treated as an open (function 13), while an attempt to delete (function 19) a 
FIFO is ignored. The only way to get rid of a FIFO is to first reset the FIFO 
attribute, then delete it. 
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The TurboDOS buffer manager module performs multi-level buffering of disk I/O, 
using least-recently-used (LRU) buffer assignment and other sophisticated 
optimizations. Buffering provides a manyfold reduction in the number of physical 
disk accesses, in both, sequential and random operations. 

The BUFFERS command allows the number and/or size of disk* buffers to be changed 
at any time* The number of buffers must be at least two, and the buffer size must 
not be smaller than the physical sector size of the disks being used. For optimum 
performance, the number of buffers should as large as possible consistent with the 
memory requirements of the programs to be ruiu. 

The buffer manager maintains its buffers on two threaded lists the "In-use" list and 
the "free* list. Whenever the file manager requests a disk access, the buffer 
manager first checks the In-use list to see if the requested disk record is already in a 
buffer. Most of the time it is, and no physical disk access is required. If not, it 
attempts to acquire a new buffer from the free list. If the free list is empty, the 
least recently used buffer (at the end of the in-use list) is written out to disk if 
necessary, and then reused. 

Before a removable disk volume is changed, it Is crucial that any buffers relating to 
that disk be written out if necessary, and returned to the free list. In single-user 
configurations of TurboDOS, this is accomplished automatically whenever the system 
pauses for console input. In multi-user configurations, buffers are flushed and freed 
by the CHANGE command (which should be executed before any disk change). 
Buffers are also flushed automatically during any lull in system activity. 

Program load 

The program load optimizer is an optional TurboDOS module which greatly improves 
the speed of program loading and overlay fetching. This module scans the allocation 
map of program files which are to- be loaded into memory, determines the 
sequentially allocated segments of the file (often I6K or more in length), and loads 
these segments at the maximum transfer rate of the disk controller. This provides a 
manyfold increase over normal sequential file access performed one record (128 bytes) 
at a time. The program load optimizer is utilized automatically by the command line 
interpreter and the autoload processor, and is also accessible to user programs by 
means of an operating system function call. In networking configurations of 
TurboDOS, program load optimization is not applicable to programs loaded over the 
network. 
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Memorw Manaygment 

The resident portion of TurboOOS resides in the topmost portion of system memory. 
TurboOOS uses a common memory management module to provide dynamic allocation 
and deallocation of memory space required for disk buffers,, de-spool requests, file 
interlocks, DO-file nesting^ etc. Dynamic memory segments are allocated downward 
from the base of the TurboOOS resident area, thereby reducing the space available 
for the TPA (transient program area). Thus, the size of the TPA can vary slightly 
from time to time during normal system operation. Deallocated segments are 
concatenated with any neighbors and threaded on a free list. A best-fit algorithm is 
used to reduce memory fragmentation. 

Networking. 

TurboOOS supports a multi-user network of interconnected microcomputers which can 
share a common pool of mass storage, printers and other peripherals. Both master- 
to-master and master-to-siave interconnections are supported. Slave processors may 
have their own local disk storage, or may be entirely down-line loaded from a master 
processor. The network protocol is a simple one, adaptable to both point-to-point 
and multi-drop links, parallel or serial. 

Networking TurboOOS incorporates an advanced failure detection and recovery 
facility that makes a properly configured master-slave network virtually crashproof. 
The master processor polls ail slave processors periodically. Repeated failure of a 
slave to respond to a poll is an indication that the slave has crashed. In this case, 
the master automatically resets and reloads the slave. Furthermore, any open files 
are automatically closed and any file interlocks are automatically released. No user 
action is required to effect this recovery. Even a malicious user running in a slave 
processor cannot compromise the processing of another slave or the files belonging to 
another user. 

A user may intentionally cause a reset and reload of his slave processor by typing two 
consecutive ASCII unit-separator characters (CTRL-J. A privileged user may reset 
and reload any slave processor via the RESET command. 

Note that this automatic recovery requires a hardware network interface which 
permits the master processor to interrupt, reset, and down-load a slave processor. 
Consult Software 2000 Inc. for hardware recommendations. 
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TurboOOS uses a start-up technique which does not depend on reserved "system 
tracks" or each disk* The TurboDOS start-up. PROM scans ail disk drives* and 
searches the directories of any ready drives lor the loader program "OSLOAD.COM". 
When this lile is found* the start-up PROM loads It Into the TPA and executes it. 

The loader program scans ail disk drives for an executaable version at the operating 
system "OSMASTER-SYS". When this file Is found, the loader program proceeds to 
load the operating system Into the topmost portion of memory, using the load address 
and load length specified by the first four bytes of the .SYS file. 

System Generation 

TurboDOS includes an easy-to-use system generator (the GEN command) for creating 
loaders, executable operating systems, and bootstrap ROMs* The GEN command is a 
specialized linkage editor which links together the desired combination of functional 
and hardware-dependent modules to create a version of TurboDOS configured with the 
desired features ami for the desired hardware. The GEN command also provides a 
powerful symbolic patch facility which may be used to establish virtually any 
operating system parameter. Consult the Configuration Guide for details. 
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Example of the Use of TurboDOS Record Latter 

The following pages contain listing? of three short programs written in Microsoft 
BASIC-80 which illustrate the manner in which record-level interlocks may be used in 
concurrent update applications* 

The first program,. INITIALS AS, creates a random data file DATABASE.DAT and 
initializes ail of its data records to the value zero. The first record in the file is a 
header record, and contains a value which gives the number of data records in the 
file* 

The second program, UPDATED AS, performs repetitive random-access updates to the 
file* Each update increments the value contained in some record by one-. Because 
this program uses the record lock facilities of TurboOOS, it may be executed 
simultaneously from several terminals at once* 

The third program, CHECKSUMS AS, processes the file sequentially and displays the 
sum of the values contained in all data records. After running UPDATED AS 
simultaneously from several terminals, CHECKSUMS AS may be used to verify that 
all updates were processes correctly. 
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100 T "INITIAl-BAS" initializes a random database* 

110 f 

120 INPUT "NUMBER OF RECORDS"?N9 
130 r 

140 ' Create random file 

130 OPEN "RVI,"DATABASESAT" 

160 FIELD #142S AS R$ 

170 » 

180 ' Write header record containing number at data records (N9) 
190 LSET R$*STR$(N9) 

200 PUT #14 
210 • 

220 1 Write N9 data records initialized to zero 
230 FOR N=2 TO N9+1 
240 LSET R$«STR$(0) 

230 PUT #1,N 
260 PRINT N? 

270 NEXT N 
280 1 

290 1 Close the file, ami set Shared and Global attributes 
300 CLOSE #1 

310 NAME "DATABASESAT" AS "#+######.#+#" 

320 END 
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100 1 "UPDATEDAS" illustrates random-access updating 
110 * using the record lock facilities of Turbo DOS. 

120 r 

130 INPUT "ENTER RANDOM NUMBER"jS 

140 INPUT "ENTER NUMBER OF ITERATIONS";N9 

130 * 

160 r Discard the first S random numbers 
170 FOR N=1 TO SOC=RND(l):NEXT N 
180 » 

190 ' Open random file and read its header record 
200 ' to determine the number of data records (R9) 

210 OPEN "RVI,"DATABASESAT" 

220 FIELD #1,128 AS R$ 

230 GET #1,1 
240 R9*VAL(R$) 

250 ' 

260 ' Generate a random record number between 2 and R9+1. 

270 ' Read-increment-write that record* using record locks* 

280 ' Repeat this process for N9 iterations. 

290 OPEN "I",#2,"$J.OK" ' enable interlocks (suspend cn conflict) 

300 FOR Nal TO N9 

310 R=INT(RND(l)*R9)+2 

320 GET #1,R 

330 X=VAL(R$) 

340 X=X+i 

350 LSET R$»5TR$(X) 

360 PUT #1,R 
370 PRINT N,R,X 
380 NEXT N 
390 » 

400 1 Finally, close the file 
410 CLOSE #1 

420 CLOSE #2 ' release interlocks 
430 END 
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100 ' "CHECKSUM'S AS" simply reads each record 
110 ' in the file, and computes the sum of them. 
120 ' This program can be used to check for the 
130 1 proper operation of "UPDATEJSAS 1 * when used 
140 ’ concurrently from several terminals. 

130 • 

160 OPEN "RV1*"DATABASEJDAT"' 

170 FIELD #1,128 AS R$ 

180 GET #14 
190 N9*VAL(R$) 

200 FOR N»2 TO N9+1 
210 GET #1,N 
220 S*S+VAL(R$) 

230 PRINT N?VAL(R$)f5 

240 NEXT N 

230 CLOSE #1 

260 PRINT 

270 PRINT "SUM =";S 

280 END 
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COMMANDS 


AUTOLOAD Command 

Turbo DOS provides a flexible and user-defined facility for loading any program (e.g^ 
a function menu) automatically at initial system cold-start and/or at each system 
warm-start. Automatic program loading at cold-start and warm-start are controlled 
by flies named COLDSTRT.AUT and WARM5TRT.AUT respectively. Automatic 
program loading takes place only If the corresponding .AUT file Is present on the 
logged-on disk. 

The AUTOLOAD command enables you to create these .AUT files. The command 
format iss 

AUTOLOAD command 

where "command" is any valid TurboDOS command that you wish to be executed 
automatically at cold-start or warm-start. The "command" may not be a multi¬ 
command string, but it may be a DO-command. 

The AUTOLOAD command creates a file named AUTOLOAD.AUT an the logged-on 
disk. By renaming this file as COLD5TRT.AUT or WARM5TRT JK UT, you will cause 
the specified "command" to be executed automatically at system cold-start or at each 
warm-start. Note that a newly-created .AUT file does not affect system operation 
until the next system cold-start. 

Example: 

QAl AUTOLOAD MB ASIC MENUPROC 
Auto load file created. 

OAl PFNAMF ATlTOLOAn.ATTT OPT nSTPT.ATIT 

A:AUTOLOAD.AUT renamed to A:COLDSTRT.AUT 
0A} 
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BACKUP Command 

The BACKUP command enables you to perform a fast disk-to-disk copy for backup 
purposes. The command format 1st 

BACKUP srcdrive dest drive ;R 

where "srcdrive* and "destdrive* specify the source and destination drives. Source 
and destination disks must be of exactly the same type and format. II the "jR" 
suffix is present, then BACKUP repeats (allowing multiple removable disks to be 
backed up) until terminated by typing CTRL-C. 

In a network configuration, BACKUP may not be used in a slave processor to access 
source or destination drives owned by the master processor. However, a slave 
console may be attached to the master processor (see MASTER command) for the 
purpose of running BACKUP. 

Examples 

QAiBACKUF As.Bi 
Insert source disk in drive A 
Insert destination disk in drive B 
Enter <cr> to begin copying: <gr> 


0A} 
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BUFFERS Command. 

The BUFFERS command enables you to change the number and/or size of disk buffers 
maintained by TurboDOS to enhance file processing performance. The command 
format is* 

BUFFERS Nn Ss 

where "n" is the desired number at buffers (at least 2), and "s" is the desired buffer 
size in bytes (128, 256, 512, 1024^, 16384), The buffer size must not be smaller 
than the physical sector size of the disks being used. For optimum performance, the 
number of buffers should as large as possible consistent with the memory 
requirements of the programs to be run. 

If there is not enough memory to allocate the requested number of buffers of the 
specified size, the BUFFERS command will allocate as many as it can. If either the 
"N* or "S" arguments are omitted, the corresponding parameter remains unchanged. 
If both are omitted, the command simply displays the current parameters. 

Examples — 

QAlBUFFERS N6 
Number of Buffers: 6 
Length of Buffers: 1024 
Current System Size: 64 K 
Memory Available: 46596 
OA] 
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gHANCg command 

The CHANGE command must be used prior to changing removable disk volumes In 
multi-user configurations of TurboDOS* The command format 1st 

CHANGE drives 

where "drives" Is a string of one or more drive letters A~JP, or if you want to 
change all disks. 

If any of the requested drives are in use by another user, your request will be denied* 
Otherwise, you, will be prompted to change the requested disk(s), and to enter 
carriage-return when you are done* Until you have pressed carriage-return, no other 
user will be allowed to access the disk(s) that you are changing* 

Examples! 

QA1CHANGS BCD 

Change disk(s) BCD, then enter carriage-returns <cr> 

0A} 

OAICHANGE.,1 
Disk(s) CO in use 
0A} 
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COPY Command, 

The COPY command enables you to copy Individual disk files or groups of flies. The 
command format iss 

COPY srcflie destfiie {options 

where ’’srcflie" and "destfiie 1 * specify the source and destination drives and files. 
Wild-card characters ("?" and "*") may be used In the "srcfiie" argument to Indicate 
that multiple files are to be copied. Wild-card characters may also be used In the 
"destfiie" argument to indicate that the corresponding characters of each source file 
specification are to be used in specifying each destination file. An "srcfiie" or 
"destfiie" argument consisting only of a drive letter (e.g. r n O") implies a file 
specification of all wild cards Cue^ "G*.*"). 

If both "srcfiie" and "destfiie" are omitted from the command line* then the COPY 
command operates In an Interactive mode. It reads successive directives from the 
console (prompted by an asterisk "*”)• A null directive terminates the command. 
The format of each interactive directive isx 

srcfiie destfiie {options 

The "options" argument may contain either "Y" or "N" (preceded by a semicolon), to 
specify whether or not you want to confirm each individual file before it is copied. 
If neither "Y" or "N" is specified and "srcfiie" contains wild cards, then the COPY 
command prompts you to specify whether or not confirmation is desired. 

The "options" argument may also contain "5" and/or "D" followed by a number from 0 
to 31. If present, these options specify the user number associated with the source 
and/or destination files, respectively. In the absence of these options, the source and 
destination flies are associated with the current user number. The "S" and n D" 
options are honored for privileged log-ons only. 

The "E” option causes each source file to be deleted after it has been successfully 
copied to the destination. 
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Two options facilitate archiving of hard disks* The "A" option causes COPY to 
bypass files which have the Archived attribute set, and to set the Archived attribute 
on files that are copied. The "C" option gives you the opportunity to change the disk 
in the destination drive if the first disk becomes fuLL 

For example, the command* 

QAl COPY Et Ar ;ACN 

could be used to provide incremental archiving of a Winchester hard disk (Es) to 
several mini-floppies (A:). 

Examples* 

OAlCQEY U1A2. Bi 

AsAMORTIZE3AS copied to BsAMORTIZEJ3A5 
AsPRIMES &AS copied to BsPRIMES .BAS 
A:5TARTREKJ3A5 copied to BsSTARTREKJBAS 
0A} 

0A1CQPY BtMAXI*.* LiQSTT^ ;Y. 

OK to copy BsMAXICOMP.TXT to CsOPTICOMP.TXT (y/n)? H 

OK to copy BsMAXIMUMS.COM to CsOPTIMUMS.COM (y/n)? Y. 

BsMAXIMUMS.COM copied to CsOPTIMUMS.COM 

OK to copy BsMAXIMUMS.FOR to C:OPTIMUM5.FOR (y/n)? £ 

BsMAXIMUMSJOR copied to CsOPTIMUMSJOR 

OK to copy BsMAXIMUM5.REL to OOPTIMUMS.REL (y/n)? & 

OAJ 

OAl CQPY 

» AUTOLOAD.COM Bt 

AsAUTOLOAD.COM copied to BsAUTOLOAD.COM 

* ♦ TXT Bs :NE 

AsREFERENC.TXT copied to BsREFERENCTXT 

A:REFERENC.TXT deleted 

A:USERGUID.TXT copied to BsUSERGUID.TXT 

AsUSERGUID.TXT deleted 

* 

OA} 
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HATg gammaml 

The DATE command enables you to set or display the system date and time. The 
command format is* 

DATE SET 

in response to which you are prompted interactively to enter the new system date (in 
format "dd mmm yy") and time (in format "hhunnuss”). You may leave the date 
and/or time unchanged simply by typing carriage-return in response to the 
corresponding prompt. The commands 

DATE 

simply displays the current system date and time. 

Examples 

Q AID ATE SET 
Date: Q7 Dec 41 
Time: 1 £sLSsQQ. 

OA} 
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delete command 

The DELETE command enables you to delete individual disk files or groups of files* 
The command format is? 

DELETE file,’option 

where "file" specifies the file to be deleted* Wild-card characters ("7" and "*") may 
be used in the "file" argument to indicate that multiple files are to be deleted* 

If "file" is omitted from the command line, then the DELETE command operates in an 
Interactive mode* It reads successive directives from the console (prompted by an 
asterisk. "*")» A null directive terminates the command* The format of each 
interactive directive iss- 

file ;option 

The "option" argument may be either "Y" or "N" (preceded by a semicolon), and 
specifies whether or not you want to confirm each individual file before it is deleted* 
If "option" is omitted and "file" contains wild cards, then the DELETE command 
prompts you to specify whether or not confirmation is desired. 
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Exampless 

OAlngt-gTg *BAS ? N 
A&AMORTIZEJBAS deleted 
AsPRIMES 3AS deleted 
AtSTARTREJCBAS deleted 
0A} 

OAipgt-gTg r ; maxt»» ?y 

OK to delete BtMAXICOMP.TXT (y/n)? 

OK to delete BtMAXIMUMS.COM (y/n)? Y, 

BtMAXIMUMS.COM deleted 

OK to delete BsMAXIMUMS.FOR (y/n)? Y. 

BtMAXIMUMSJOR deleted 

OK to delete BsMAXIMUMSJ&EL (y/n)? fcL 

OA} 

OAIDELEIE 
* AUTOLQAD.CQM 
AtAUTOLOAD.COM deleted 
» *.TYT 

Ambiguous filenames confirm individual files (y/n)? fcL 
AtREFERENCTXT deleted 

As USERGUID.TXT deleted 
*■ 

OA} 
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DIR Command 

The DIR command enables you to display an alphabetized disk directory on the 
console or printer. The command format ist 

DIR file ;L 

If the "file" argument is present, it specifies the desired disk drive. Otherwise, the 
logged-on drive is referenced. The "file" argument may also include an ambiguous 
file specification to indicate that cnly a specified group of files is to be displayed. 

If the ";L" suffix is present, then the directory is printed. Otherwise, it is displayed 
on the console. 

The DIR command displays only files created under the current user number. (Also 
see the USER command^ 

Exampless 

QAl DIR ? L 

—directory of ail A-drive files cn printer— 

OA} 

QAlDIR. Bl 

—directory of ail B-drive files cn console— 

OA} 

QAlDIR *.BA£ 

—directory of A-drive J3AS files on console-. 

OA} 
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The OO command enables you to execute a pre-defined sequence of TurboOOS 
commands which you have previously placed in. a disk file. The command format iss 

OO defile argl arg2 _ argN 

where "dofHe" specifies a file of commands to be executed (called the "DO-file"). If 
"dofUe* does not specify an explicit file type, then the type "•DO" is assumed. If the 
OO command has no additional arguments following "dofile", then the commands in 
the specified DO-fiie are simply executed by TurboOOS in sequence. 

The optional arguments "argl* through "argN 9 are arguments to be substituted into 
marked locations in the DO-file. Any number of arguments is permitted. Arguments 
containing embedded spaces must be enclosed in single or double quotes. If one or 
more of these arguments are present, then the DO-command makes a temporary copy 
of the DO-file In which the arguments are substituted as required. The commands in 
the temporary file are then executed by TurboOOS in sequence. The temporary file 
is given the same name as the original DO-fiie except that the last character of the 
file type is changed to a dollar sign (e.g., "GENERATE.DO" is copied to 
"GENERATE.DO$"). The last line of the temporary file consists of a DELETE 
command which causes the temporary file to be deleted at the end of execution. 

The DO-file Is simply an ASCII file at any desired length, each line of which contains 
a valid TurboOOS command or multi-command string. Thus, you can create DO-files 
with any conventional text editor. If argument substitution is desired, then you must 
mark each substitution point in the DO-fiie by enclosing the argument number in 
braces. For example, "131" will be replaced by the value of the argument "arg3". A 
default value may follow the argument number, separated by a comma (e.g., 
"{12,DEFAULT}"), and will be used if the corresponding argument of the DO command 
is missing or nuLL 

A DO-fiie may contain any number of embedded DO commands, even in multi- 
command strings. TurboOOS supports full nesting of DO-files to any reasonable 
depth. 

Certain commands (such as COPY, RENAME and DELETE) and other programs expect 
interactive input from the console keyboard. If such a command or program is 
executed within a DO-file, then its console input comes from the DO-file rather than 
the keyboard. An exception is console input solicited by means of direct console I/O 
(function 6) or direct calls on the BIOS vector. 
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Examples 

Suppose you have created a file named RUNBASIC-DO containing the following lines 
of ASCII texts 

BASCOM UlJiEUlJJ’RNsUi^ASO^Z/S/Cl 

TYPE {1}J>RN fL 

L80. {1}«REL(2}/E,{1}.C0M/N- 

DELETE 

U1.REL 

U1.PRN 

<nuil line> 

U1 * 


Then you could execute this DO-file as follows: 

QA1 DO RUNBASTC PRIMES /M 

OAjBASCOM PRIME5*REL,PRIMESJ 3 RN=PRIMES^AS/Z/S/C 
•^compilation^. 

OAJTYPE PRIMESJPRN ;L 
...listing on printer^. 

0A}LS0 PRIMES.REL/M/E^>RIMES.COM/N 
•••link map^. 

OAjDELETE 

* PRIMES.REL 
AiPRIMES .REL deleted 

* PRIME5.PRN 

AiPRIMES .PRN deleted 

* 

0 AiPRIMES 

.^execution of primes program^. 

0A1DELETE RUNBASIC.DO$ 

A:RUNBA5ICJDO$ deleted 
OAl 
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PBJOffi Quaaaaii 

The ORIYE command enables you to display physical disk characteristics on the 
console or printer. The command format iss 

DRIVE file ;L 

If the "file" argument is present, it specifies the desired disk drive. Otherwise, the 
logged-on drive is referenced. If the "jL" suffix is present, then the drive 
information is printed. Otherwise, it is displayed on the console. 

Example: 

QAlDRIYEBi 

Disk characteristics, drive B:DOCUMENT.TXT 


Maximum data capacity : 1224K 

Allocation block size : 2K 

Number of directory entries : 2 56 

Physical sector size : 1024- 

Physical sectors per track : 16 

Physical tracks per disk : 77 

Number of reserved tracks : 0 

OA} . 
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DUMP Command 

The DUMP command enables you to’ display a combined hex/ASCII file dump on the 
console or printer* The command format iss 

DUMP file jL 

where "file"* specifies the disk file to be dumped* If the "jL" suffix is present, then 
the hex/ASCH dump is- printed* Otherwise* it is displayed on the console. 

Examples 

QAIPUME B«DUMP«CQM 
^combined hex/ASCH dumpu. 

0A} 
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ggASgPTR Command 

The ERASEDIR command enables you to erase the entire directory on a specified 
disk. The command format is: 

ERASEDIR drive 

where "drive" specifies the disk to be erased. 

CAUTIONr This command erases ail information on the specified disk, regardless of 
user number or read-only attributes. Its use is r e stri cted to privileged log-ons only. 

Examples 

OAiERASEDTR Bt 

OK to erase directory on drive B (Y/N)? 

Directory erased 
0A} 
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ECO. Command 

The FIFO command enables you to create a disk-resident or RAM-resident FIFO. 
The command format isr 

FIFO file 

where "file* specifies the desired drive and name. If the specified FIFO already 
exists, its characteristics are displayed. Otherwise, you are prompted for the 
necessary parameters to create a new FIFO. 

Examples; 

OA1FTFO BiBATCH.DO 

FIFO file not found, creating new file 

Enter FIFO type (Ram/Disk); D_ 

Enter maximum number of records (1-65535): 1000 

FIFO file created 

OA] 

OAlFIFQ BsBATCHiDQ 
FIFO is Disk resident 
Maximum number of records: 1000 
Current number of records: 0 
0A} 


3-16 



User's- Guide t« TurboDOS 
Copyright (G) 1981 by Software 2000 Inc. 

Commands 


pnrMA^ Command 

In order to keep; track of which blocks of disk space are occupied and which are free, 
TurboDOS maintains on each disk an allocation map for that disk's space* Certain 
program malfunctions (e.g., failure to close a newly-created file) can create 
discrepancies be t w een the allocation map and the directory of a disk* The result is 
that disk blocks may occasionally become unavailable. 

The FIXMAP command enables you to regenerate the allocation map for a disk, 
thereby reclaiming any disk blocks that may have become unavailable in this fashion* 
The command format is* 

FIXMAP file 

If the "file* argument is present, it specifies the desired disk drive. Otherwise, the 
logged-on drive is referenced* 

In a multi-user system, you cannot use FIXMAP on a drive that Is in use by another 
user* 


Examples 


OAiHXMAP B; 

Drive B disk map re-initialized 


Drive C disk map re-initialized, 3 allocation biock(s) gained 
OA] 
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FORMAT Command 

The FORMAT command enables you to initialize or verify a disk. The command 
format iss 

FORMAT drive ^options 

where "drive 1 ' specifies the disk to be initialized. The command normally initializes 
and verifies the dlsk^ but the ";V" option may be used to cause verification only. If 
the "jR" option is present,, then FORMAT repeats (allowing multiple removable disks 
to be initialized or verified) until terminated by typing CTRL-C. 

Other options on the FORMAT command are hardware-dependent. For floppy disks, 
the following options are available! 

1 or 2 one- or two-sided diskette 
S or D single- or double-density 
T or C TurboDOS or CP/M-compatible format 
3, 4 or 8 For minifloppies: 35-, 40- or 80-track disks 

In a network configuration^ FORMAT may not be used in a slave processor to access 
a drive owned by the master processor. However, a slave console may be attached 
to the master processor (see MASTER command) for the purpose of running FORMAT. 

Example: 

0A}FQRMAT,a& ; 2 DT 

Insert disk to be formatted in drive 5 
Enter <cr> to begin formatting: <«•> 

Starting format pass 


Starting verify pass 


OA} 

NOTE: On systems with several types of disk storage units, several hardware- 
dependent versions of the FORMAT command (called FMTxxx) will generally be 
provided. 
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LABEL f>fl " ll " and 

The LABEL, command enables you to record a volume label on any disk. The 
command format iss 

LABEL label 

The "label* argument has the same format as a file specification. The name and 
type fields are used as a volume label for the specified drive. If no drive is specified 
explicitly, then the logged-on drive is labelled. The label recorded on a disk may be 
displayed using the DIR or DRIVE command. 

Examples 

0 A} LAB EL BiPAYABLE&DAT 
Disk label written. 

QAlDRIYE, fll 

Disk characteristics, drive B:PAYABLE5-DAT 

(metCm) 

0A} 
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LOGON Command 

The LOGON command provides password-type security in* multi-user configurations of 
TurboDOS. The purpose of this command is to prevent unauthorized access to the 
system and to protect private file libraries* The command format iss 

LOGON 

in response to which you. are prompted to enter your user-ID from the console 
keyboard* The user-IO is validated against the file USERID .SYS in the user 31 
library. U5ERID.SYS is an ASCII text file containing entries of the form: 

userid,, [password], usemo[P] r [drive] 

where "userid" and "password" are up to 8 characters in length, "usemo" is a user 
number Q~*30, and "drive" Is a drive letter A~*P. The password and drive fields are 
optional. If your user-ID has an associated password specified In U5ERID.SYS, then 
LOGON prompts you to enter a password, and validates it. The log-on succeeds only 
if you enter both the user-ID and password co r rectly, in which case your console is 
logged onto the specified user .number, and the specified drive is selected as the 
default disk. If your entry in USERID .SYS has the user number suffix "P", you are 
logged-on as a "privileged” user, enabling you to access various protected facilities of 
TurboDOS. 

If the user 31 library also contains a file named 5YSLOCLSYS, then the LOGON 
command will automatically record your log-on in that file. 
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The LOGOFF command is used in multi-user configurations at TurboDOS to terminate 
your session. The command format i st 

LOGOFF 

The LOGOFF command sets the user number to a reserved value (31) and selects the 
system drive as the de f ault disk. The library for user 31 normally contains only the 
LOGON.COM command file and the U5ERID.SY5 validation file. Consequently, no 
further activity can be performed until a successful LOGON has been accomplished. 

If the library for user 31 on the system drive also contains a file named 
"SYSLOG.SYS", then the LOGOFF command will automatically record your log-off. in 
that file. 


Examples 
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MASTER Command 

If you are using a slave console in a networking TurboOOS configuration,- the MASTER 
command enables you to- attach your console to the master processor- The command 
format isx 

MASTER 

which attaches your console to the master processor- To detach from the master 
processor (and resume normal slave console operation), enter an Attention-Abort 
sequence (CTRL-S CTRL-O* 

While attached to the master, you can make attention requests of the master 
processor by using CTRL-A (instead of the usual CTRL-S)- 

NOTE: The MASTER command requires that the master operating system be 
generated with a special console driver module (CONREM). 


Exampler 


3B1MASIER. 

Console attached to master processor 
Enter User-ID: SYSTEM. 

Enter Password: SECRET 
QAlBACKUP A: B; 


0 A] LOGOFF 

Enter User-ID: <CTRL-S CTRL-O 
Console detached from master processor 
3B} 
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PgTMT PflmmMd 

The PRINT command enable* you to control the routing of your print output. The 
command format is: 

PRINT keyword keyword.. 

where "keyword" is chosen from the following list: 

LOCAL 

REMOTE 

PRINTERap 

QUEUEsq 

ORIYEad 

FILE 

CONSOLE 

OFF 

and "p", "q" and "d #r are printer, queue and drive letters in the range A.J*. Any 
keyword may be abbreviated to a single letter ("P" for PRINTER, "Q" for QUEUE, 
etcj. 

PRINT DRiVEsd QUEUgaq causes print output to be spooled to print files on the 
specified drive, then queued automatically on the specified print queue for de-spooled 
printing. 

PRINT DRTVFsd FTt-F. causes print output to be spooled to print files on the specified 
drive, but not queued automatically for printing. 

PRINT PRTNTERsp causes print output to be routed directly to the specified printer 
without intermediate spooling to disk. 

PRINT CONSOLE causes print output to be routed to the console. 

PRINT OFF causes print output to be discarded. 

PRINT without keywords causes the current print routing to be displayed. 

In a networking system, you can route your printed output to either local (slave- 
owned) or remote (master-owned) printers by using the keywords LOCAL or REMOTE 
in any PRINT command. 
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Examples 

0A}PRIMT.D?C QrA 

Printing is to LOCAL SPOOLER on DRIVE C to QUEUE A 
0A} 

0A1ER1MT P»EL 

Printing is to LOCAL PRINTER 5 
0A} 

QAl PPTNT r 

Printing is to LOCAL CONSOLE 
0A} - 

OAIERIMT.O 

Printing is to LOCAL OFFLINE 
0A} 
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PRINTER rammand 

The PRINTER command enables you to control de-spooled printing. The command 
format isr 

PRINTER p keyword keywords. 

where "p 1 * is a printer letter in the range A—P which specifies the printer to be 
controlled, and "keyword"!* chosen from the following list: 

LOCAL 

REMOTE 

QUEUE*** 

OFFLINE 

STOP 

GO 

BEGIN 

TERMINATE 

Any keyword may be abbreviated to a single letter ("T" for TERMINATE, "Q" for 
QUEUE, eta). 


PRINTER p QUEUEsq causes the specified printer to take its print jobs from the 
specified de-spool queue. If the printer is currently printing from another queue, 
then the new assignment takes effect at the end of the current print job. 

PRINTER p OFF causes the specified printer to be taken offline at the end of the 
current print job. An offline printer may be accessed for direct printing. 

PRINTER p STOP temporarily suspends de-spooling to the specified printer (e.g«, to 
correct a paper jam). 

PRINTER p GO resumes de-spooling to the specified printer. 

PRINTER p BEGIN stops de-spooiing to the specified printer, and causes the current 
print job to be reprinted from the beginning when de-spooling is resumed. 

PRINTER p terminate terminates the current print job on the specified printer, 
and continues with the next queued job. The terminated print file is not deleted 
from disk, however, so the job may be manually requeued with the QUEUE command. 
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printer p with no keywords displays the current status of the specified printer. 

In a networking system,, a PRINTER command run in a slave processor defaults to 
REMOTE unless the LOCAL keyword is included in the command* 

Examples* 

QAl PRTNTER R Q=A 

LOCAL Printer B- Assigned to QUEUE A 
0A] 

0A1ERINTER.B S 

LOCAL Printer B Assigned to QUEUE A (Stopped) 

0A} ' 
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qUEUE Command 

The QUEUE command enables you to manually queue print files for de-spoaled 
printing* The command format is: 

4 

QUEUE file ^options 

where "file" specifies the file to be queued* Wild-card characters (”?” and "*") may 
be used in the "file 1 * argument to indicate that multiple files are to be queued* 

If "file 1 * is omitted from the command line, then the QUEUE command operates in an 
interactive mode. It reads successive directives from the console (prompted by an 
asterisk "*"). A null directive terminates the command* The format of each 
interactive directive is: 

file ;options 

The options argument may include: 

"Y" or "N" to specify whether or not you want to confirm each individual file 
before it is queued* If neither is specified and "file" contains wild cards, then 
the QUEUE command prompts you to specify whether or not you want 
confirmation. 

"S" or "D" to specify whether you want the queued files to be saved or deleted 
after printing. If neither is specified, then the files are saved. 

"Qsq" (where is a queue letter in the range A.~P) to specify which de-spool queue 
to use. If not specified, the current queue (as specified in the last PRINT 
command) is used* If there is no current queue in effect, then the "Qsq" option 
is required* 


"L" or "R" to specify whether you want printing to be local or remote (meaningful 
only from a network slave). If neither is specified, current print routing (as 
specified in the last PRINT command) is used. 
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Example; 

QAiQUEUE.-PRINTS ;NDQ=A 
A:-PRINT-U)08 queued 
AJ-PRINT-.Q14- queued 
As-PRINT-.Q20 queued 
0A} 
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ggggnn* Command 

The RECEIVE command enables you to read one record from a FIFO, and to display it 
on the console* The command format is* 

RECEIVE file 

where "file"' specifies the FIFO you wish to read* This command may be useful 
where FIFOs are used as message mailboxes In a multi-user system* 


Examples 


OAiRECHYE MA1LBQX.RMN 

DICK—.NEED TO MEET WITH YOU—JEFF 

OAl 

Note that RECEIVE displays only one record* If you want to display or print the 
entire contents of a FIFO, use the TYPE command Instead* 
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ggNAMg Command 

The RENAME command enable* you to rename individual disk file* or groups at files* 
The command format is* 

RENAME oidfile newfiie joption 

where "oidfile* and "newfiie* specify the old and new 1 file names. Wildcard 
character* ("?* and "*") may be used in the "oidfile* argument to indicate that 
multiple files are to be renamed. Wild-card characters may also be used in the 
"newfiie* argument to indicate that the corresponding characters, of each old file 
name are to be used in naming each new file. An "oidfile" or "newfiie" argument 
consisting only of a drive letter (e.g^ "Cr") implies a file specification of ail wild 
cards (Le^ "G*v*"). 


If both "oidfile" and "newfiie* are omitted from the command Jin«v then the RENAME 
command operates in an interactive mode. It reads successive directives from the 
console (prompted by an asterisk "*")• A null directive terminates the command. 
The format of each interactive directive is* 

oidfile newfiie,'option 

The "option" argument may be either "Y" or "N" (preceded by a semicolon), and 
specifies whether or not you want to confirm each individual file before it is 
renamed. If "option" is omitted and "oidfile" contains wild cards, then the RENAME 
command prompts you to specify whether or not confirmation is desired. 
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OAl RENAME »N 

♦ »BAK »PRV 

A^EFERENCBAK renamed to A&EFERENOPRV 
AsUSERGUID.BAK renamed to AsUSERGUIDJ»RV 

♦ MXX *£AK 

A:LETTER .TXT renamed to A:LETTER .BAK 
AOIEFERENC.TXT renamed to AsREFERENCBAK 

AiUSERGUID.TXT renamed to A:U5ERGUID.BAK 

♦ 

OAJ 

fl Al PFNAMF R;MAYT»» QPT*» »Y 

OK to rename BsMAXICOMP.TXT to BjOPTICOMP.TXT (y/n)? H 

OK to rename BjMAXIMUMS.COM to Bd3PTIMUMS.COM (y/n)? £ 

BjMAXIMUMS.COM renamed to Bd3PTIMUMS.COM 

OK to rename BjMAXIMUMSJOR to BiOPTIMUMS^OR (y/n)? £ 

BjMAXIMUMSJOR renamed to BjOPTIMUMS.FOR 

OK to rename B:MAXIMUM5.REL to B:OPTIMUMS.REL (y/n)? fcL 

OA} 
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RESET Command 


The RESET command enables a privileged user to reset one or more network slave 
processors from any terminal of a networking TurboOOS system. Up to 16= slaves are 
denoted by the letters A~*P r and the command format iss 

RESET slaves 

where "slaves" is a string of one or more slave letters A..«F, "“ 1r if only the 
requesting slave is to be resets or "** If all slaves are to be reset* 

Examples! 

QAl RESET D 
0A} 

QAl RESET ~ 

Enter User-IDt 


3-32 



User**’ Guide t» TurboDQS 
Copyright (C) 1981 by Software 2000 Inc* 

Commands 


ffiwn Command 

The SEND command enables you to write one record to a FIFO* The command 
format Iss 

SEND file message 

where "file" specifies the FIFO you wish to write, and "message" is any text you wish* 
This command may be useful where FIFOs are used as batch queues or message 
mailboxes in a muili-user system* 

Examples: 

OAlSEND BATCH.DO DO COMPLINK BICPROC 

QAlSFNP MATLBOY.RMN DTCK—NEFfi TO MEET WTTH YOU-JFFF 

OA} 
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SET Command 

The SET command enables you to set and clear the various file attributes, and has 
the following formats 

SET file ^options +onattributes -offattributes 

where "onattributes* and "offattributes" consist of any set of the mnemonic letters E, 
S, F, R, G, and A (corresponding to the attributes Exclusive, Shared, FIFO, Read-only, 
Global and Archived). Attributes following the "+" are set, attributes following the 
"-" are cleared, and all other attributes are left unchanged. 

If "file* contains wild-cards, the SET command can modify the attributes of multiple 
files; the usual "Y" or "N" options may be used to specify whether or not you want to 
confirm individual files. If "file" Is omitted from the command line, then the SET 
command operates in interactive mode. 

Examples 

QAISET * COM tRG, -S, 

sets all .COM files on the default drive to Read-only, Global, and nfll Shared. 

If "file" contains only a drive specification, then the SET command may be used to 
set a disk volume read-only or read/write. 

Example: 



Drive B set to read-only 

QA)SEIBl.;-R 

Drive B set to read/write 


0A} 
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SHOT Command, 

The SHOW command enables you to display the settings of file attributes* The 
command format is: 

SHOW file ^options 

If "file* contains wild-cards, the SHOW command can display the attributes of 
multiple files* If "file 1 * is omitted from the command line, then the SET command 
operates in interactive mode* "Options* may include ;Y or ;N to specify whether or 
not to pause after displaying each file, or ;L to print rather than display. 

For example: 

QAlSHOW .♦ ?L 

prints a listing of file attributes for all files on the B-drive. 

If "file* contains only a drive specification, then the SHOW command may be used to 
determine whether a disk volume is read-only or read/write* 

Example: 

QAlSHQW Ai 

Drive A set to read-only 

Q AlSHOW Bi 

Drive B set to read/write 
0A} 


3-35 



User's Guide Zo TnrboDOS 
Copyright (Q 1981 by Software 2000 Inc* 
Commands 


TYPE Command 

The TYPE command enables you to display the contents of an ASCII file on the 
console or printer* The command format 1st 

TYPE file ;L 

where "file* specifies the disk file to be displayed. If the "jL" suffix is present, then 

the contents of the file is printed. Otherwise, it is displayed on the console. 

% 

Examples 

QAiTYPE B;TURBQDOS.DQC 
—ASCII display— 

0A} 
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nSFg Cammand 

The USER command enables you to change the current user number. This command 
is honored only if you have logged-on as a privileged user. The command format is; 

USER usemumber 

where "usemumber 1 * specifies the desired user number (between 0 and 31). If the 
"usemumber 11 argument is omitted, then the current user number is simply displayed 
(it also appears in the command prompt}* 

Example* 

QAl USER 2 

Current user number; 2 
2A1 U5ER Q 

Current user number; 0 
0A] 
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VgttlPY Command 

The VERIFY command enables you to scan a volume (typically* a hard-disk) for bad 
blocks and to mark them so that TurboDOS will avoid their use* The command 
format iss- 

VERIFY drive 

where "drive" specifies the disk to be verified* If bad blocks are detected, the 
command will create a read-only directory entry with the filename BLOCKSJJAD to 
mark the defective blocks* 

NOTEt the bad-block marking function of the VERIFY command presently works only 
in a single-user configuration of TurboDOS* 
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gP/M.gQMPATTBLg gUNgTTONS 

AIL TurboOOS functions are invoked by means at a call to 00Q5H with a function 
number in the C-register. Invalid function numbers result in no operation* 

Function Qr Return t a Qp«**iny Sssstem 

Called withe C » 0 

Returns with* (does not return) 

Notes* This function (also called "warm start 4 *) is used to terminate execution 
a transient program* The same function is more commonly performed 
executing a jump to location 0000 H, which has exactly the same effect* 

Function It Input fihaEMlCC from 

Called with* C = 1 

Returns with* A = input character 

Notesz The console input character is echoed to console output. 

Function 2i Output Character to. Comale 

Called withs C * 2 

E s output character 

Function 3t Tnptrt Character from Reader 

Called withs C = 3 

Returns withs A 3 input character 

Notess If the reader device is not implemented, this function performs no 
operation. 
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Function 4r Output Character to Punch 

Called with* C * 4- 

E * output character 

Notess If the reader device is not implemented, this function performs no 
operation. 

Function It Output Character ta. Printer 

Called withx C = 5 

E s output character 

Notes* . If the spooler is activated^ the character is actually output to a print 
file. 


Function fit Hinyt (Console In pnt/Oirtpnt 

Called with* C =-6 

E 3-1 (for console Input) 

output character (for console output) 

Returns- withx A = Input character 

0 if no input available 

Notess U the E-register contains a value other than -i, then that value is sent 
to the console device as an output character. If the E-register contains -1, then 
any available console Input character is returned in the A-register. If no console 
input character is available, then 0 is returned in the A-register. This function 
does not echo console input characters to console output. 

Function 7t Return T/Q Assignments 

Called with! C = 7 

Returns withx A = I/O Assignment Byte 

Notess This function simply returns the value of RAM location 0003 H. 
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Function Xt. Set I/Q Aaaignmenta, 

Called with* C * 

E * I/O Assignment Byte 

Notes This function simply sets the value of RAM location 0003H. It has no 
effect whatever cn TurboDOS I/O assignment. 

Function. Si Output, Buffer ta Console 

Called with* C = 9 

DE * buffer address 

Notes* ‘ A string of characters terminated by "$” is output to the console. 

Function lQi Input Buffer from Console 

Called with* C a 10 

DE a buffer address 

Notess The first byte of the buffer must be preset to the maximum number of 
characters to be Input. Console input is accepted until terminated by a carriage- 
return. Input errors may be corrected by using backspace or delete characters to 
erase one character, and CTRL-U or CTRL-X to erase the entire line. On 
return, the second byte of the buffer contains the actual number of characters 
input from the console. The input string is returned starting in the third byte of 
the buffer. 


Function lit Return Connote Status 


Called with* C * 11 


Returns withs A 


•1 if oonsoie input is available 
0 if console input not available 
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Function \2x QdS. Version 

Called with* C * 12 

Returns with* HL a Q022H (CP/M Version 22) 

BA » 0022H (CP/M Version 2.2) 

O a environment vectors 

bit 7 a 1 for master processor 
bit 6 a 1 for privileged log-on 
bits 3-0 a slave processor ID (0«*13) 

£ a lxH (TurboDOS Version 1.x) 

Notes* The TurboDOS version number is returned In the E-register, and the 
environment vector In the D-register» The latest compatible CP/M version 
number is returned in the HL- and BA-cegisters* 

Function I3r Beset Plak Siratem 

CaUed with* C a 15 

Returns with* A = 0 

Notes* In TurboDOS r the only effect of this function is to reset the record 
buffer address to 0080H. 

Function 14t Select Default Drive 

Called with* C a 14 

E a default drive (0="A", U"BV-, 15="P") 

Function 15* Open Flic 

Called with* C = 15 

DE a FCB address 

Returns with* A = 0 if successful 

-1 if file not found 
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PtmgtiQB 1 £* Clsac EX u 

Called with* C * 16 

OE * FCB address 

Returns with* A * 0 ii successful 

•1 If file not found 

Function 17* Soarch for First Fite 

Called withs C * 17 

OE * FCB address 

Returns'withs A * 0, l, 2 or 3 if successful 

-l if file not found 

Notess Returns with directory record (four entries) in record buffer. A-register 
specifies which of the four directory entries was found. 

Function l&z Search for Heart File- 

Called withs C * IS 

Returns withs A a 0, 1, 2 or 3 if successful 

-1 if file not found 

Notess Continues search initiated by function 17. Continues from last directory 
entry found. Returns with directory record (four entries) in record buffer. A- 
register specifies which of the four directory entries was found. 

Function 19* Dninrtn Pllo 

Called withs C = 19 

OE a FCB address 

Returns withs A a 0 if successful 

-1 ii file not found 

Notess If FCB contains wild-cards, ail matching files are deleted. 
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Function 2Qt Read, Next RficacL 


Called withs C = 20 

OE = FCB address 

Returns withs A * 0 if. successful 

1 if at end-of-fiie 

2 if reading unwritten data 

, 8 il reading locked record 


Function 21 1 Tritg- Mart Record 


Called witiu C * 21 

DE = FCB address 

Returns with* A * 0 if successful 

1 if file too large 0134 MB) 

2 if disk full or write-protected 
8 if writing locked record 

-i if no directory space 


Ftmetion 22 : Cr gate EiiC 

Called witiu C * 22 

DE = FCB address 

Returns with* A = 0 if successful 

-1 if no directory space 

Function 231 Rename File 

Called withs C * 23 

DE » FCB address 

Returns withs A = 0 if successful 

•1 if no file found 

Notess The first 16 bytes of the FCB contains the file reference to be renamed, 
and the next 16 bytes contains the new file reference to be used. Wild-cards In 
the first reference may cause multiple flies to be renamed. Wild-cards in the 
second reference cause the corresponding character positions to remain 


4-6 



User's Guide to TurboDOS 
Copyright (O 1981 by Software 2000 Inc. 

CP/M-Compatihle Functions 


unchanged* 

Function 2Sr Brtimi Ready Vnctnr 
Called with* C = 24- 

y 

Returns vithx HL * ready vector 

Notes* This function replaces the "Return Login Vector" function of CP/M* 
(TurboOOS does not require disks to be logged-in before usej The ready vector 
contains a one-bit for each drive that is ready, and a zero-bit for each drive that 
is not ready* The least significant bit corresponds to drive "A”, and the most 
significant bit to drive "P". This function makes it possible for programs to scan 
ail ready drives in search of a file. 

Function 25* Return Default Pri-m- 

Called with* C a 25 

Returns with* A = default drive (0=”A", 1*"BV~, U="P n ) 

Function 26t Set Record Buffer 

Called with* C * 26 

OE s record buffer address 

Notes The record buffer address (sometimes called the "DMA address") is set 
to 0080H by default, unless this function is used to change it to another value. 

Function 27x Return Disk Allocation Information 

Called withs C = 27 

E = drive (0="A", la«BV~> 13»"P") 

Returns withs A = block size (3=1 K, 4=2K,~., 7=16K) 

C = directory blocks 
DE = remaining blocks 
HL a total blocks 


Notess This function is not compatible with CP/M. (Function 27 in CP/M is 
used only by the STAT utility.) 
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Function 7Z* Vritm- Protect Drive- 
Called with* C * 28- 

Notes* Write protects the default drive until the next warm-starri 
Function 25» HeBUR Write Protect Vector 
Called with* C = 25 
Returns with* HL = write-protect vector 

Notes* ' The write-protect vector contains a one-bit for each drive that Is write- 
protected,. and a zero-bit for each drive that is nori The least significant bit 
corresponds to drive "A", and the most significant bit to drive "P". 


Function 30; Set File Attributes. 

Called with* C = 30 

DE s FCB address 

Returns withz A = 0 if successful 

-1 if file not found 


Notes* This function searches the directory for the file referenced by the FCB, 
and updates the file attributes in the directory from those in the FCB. The file 
attributes are stored in the sign (parity) bits of FCB bytes 2 through 12. 


Function 31» Return Phvriml Disk Information 


Called with* C 
E 


31 

drive (0*"A n , le"BV-45-"?") 


Returns withx A 

BC 

DE 

HL 


sector size (0*128, 1=256, 2=512,^., 7=i6K) 
reserved tracks 
tracks per disk 
sectors per track 


Notes* This function is not compatible with CP/M. (Function 31 in CP/M is 
used only by the STAT utility.) 
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Pmwtion 22s Set/Setoa Uses. HambcL 

Called with* C * 32 

E * user number 0^31 (or -1) 

Returns withx A * user number 0 «m31 

Not ess If the E-register contains the value -i* then the current user number is 
returned in the A-register. If the E-register contains some other value and the 
user is privileged^ then the the current user number is changed to that value 
(modulo 32). 

Function 33t Read Random Recant 

Called withx C * 33 

DE a FGB address 

Returns withx A * 0 if successful 

1 if reading unwritten data 

3 if error changing extents 

4 if reading unwritten extent 

6 if random record number too large 
8 if reading locked record 

Notesx This function reads the record number specified by the random record 
number field (FCB bytes 34 through 36). 
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Function 34» UTrfrte Random Record 

Called with* C « 34- 

DE = FCB address 

Return* with* A = 0 if successful 

2 if disk full or write-protected 

3 if error changing extents 

5 if no directory space 

6 if random record number too large 
3 if writing locked record 

Notes* This function writes the record number specified by the random record 
number field (FCB bytes 34 through 36). 

Function 3 Ss. Compute File Size 

Called with* C = 35 

DE = FCB address 

Returns viths A * o if successful 

•1 if file not found 

Notess This function computes the size of the file referenced by the FCB, and 
returns the number of records in the random record number field (FCB bytes 34 
through 36). 

Function 36i Set Random Record 

Called withx C * 36 

DE a FCB address 

Notess This function returns the current file position in the random record 
number field (FCB bytes 34 through 36). Since the sequential access functions 
(20 and 21) do not update the random record number field, function 36 should be 
used when switching from sequential to random access. 
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Partition Hi RSSBL v ^ flf 

Called with* C * 37 

DE * reset vector 

Notes* This function write-enables the drives which correspond to one-bits in 
the reset vector. The least significant bit corresponds to drive "A", and the most 
significant bit to drive "P*. 

FwmrHon 40s Wrfrn- Bandam Regard with Zero Fill 

Notes* Turbo DOS treats f motion 40 as a synonym for function 34. 
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Fite ConttBl ftloefc Qryanlga-Hflir 

The File Control Block (FCB) consists of an area of 33 bytes for sequential file 
access, or 36 bytes for random file acc e ss* The FCB organization is shown below; 


Bytea 

Ftete 

Description. 

l 

Drive 

Qsdefault, i="A", 2="B",—* 

2—9 

Name 

file name in ASCII, right-padded with spaces 
sign bits reserved for file attributes 

10—12 

Type 

file type in ASCII, right-padded, with spaces 
sign bits reserved for file attributes 

13 

Extent- 

least significant 5 bits at extent number 

14. 

Flags 

used by TurboDOS (Do Not Use) 

13 

Extent' 

most significant 3 bits of extent number 

16 

Record 

Count 

number of records in current extent 0—123 
(Do Not Use) 

17-32 

Map 

allocation map of current extent (Do Not Use) 

33 

Current 

Record 

current record number 0—127 in current extent 
used and Incremented by sequential read and write 

34-36 

Random 

Record 

20-bit record number used by random read and write 
byte 34- is least significant 
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MOT!" 


TurboOOS provides a full simulated "BIOS branch table" in order to support programs 
which make direct calls an the CP/M BIOS*. This branch table always begins 2 35 
bytes below the top of memory in order to ensure that it begins on a page boundary 
(as it does in CP/M)* The entry points are: 


xFOQH 

JMP 

BOOT 

Cold Start 

xF03H 

JMP 

WBOOT 

Warm Start 

xF06H 

JMP 

CONST 

Console Status to A-reg 

xF09H 

JMP 

CONIN 

Console Input to A-reg 

xFOCH 

JMP 

CONOUT 

Console Output from C-reg 

xFOFH 

JMP 

LIST 

Printer Output from C-reg 

xF12H 

JMP 

PUNCH 

Punch Output from C-reg 

xF15H 

JMP 

READER 

Reader Input to A-reg 

xFISH 

JMP 

HOME 

Set Track to Zero 

xFIBH 

JMP 

SELDSK 

Select Disk Drive from C-reg 

xFlEH 

JMP 

SETTRK 

Set Track from BC-regs 

xF21H 

JMP 

SETSEC 

Set Sector from BC-regs 

xF24H 

JMP 

SETDMA 

Set DMA Address from BC-regs 

xF27H 

JMP 

READ 

Read Disk Sector 

XF2AH 

JMP 

WRITE 

Write Disk Sector 

xF20H 

JMP 

LI5TST 

List Status to A-reg 

xF30H 

JMP 

SECTRN 

Sector Translate Subroutine 


The disk read and write entrypoints are honored only for privileged users* 
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ADDITIONAL -EUMCimMS- 

Additional TurboDOS fuictions use function numbers in the range 64.^127, and are 
intended primarily for use by TurboDOS commands and internal processes* These 
functions may be used safely by user programs^ except for those marked "Do Not 
Use". 

Function S3i Set Date Sc Time? 

Called with* C a 23 

HL = Julian date 
D hours (0_23) 

E a minutes (0_39) 

B a seconds (0_*59) 

Notesa The Julian date in HL should be the number of days since the base date 
of December 31, 1947. Dates prior to the base date are represented by negative 
numbers. 

Function 24» Return Date Time 

Called with* C a 24 

Returns with* HL = Julian date 

D a hours (0««23) 

E a minutes (Q_59) 

B a seconds (0«*39) 

Notesr The Julian date in HL is be the number of days since the base date of 
December 31, 1947. Dates prior to the base date are represented by negative 
numbers. 
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Called with* C = 86 

DE * POR packet address 

Returns with* A = 0 or -1 

Notes* This function is available for privileged log-ons only. It provides direct 
access to the physical disk drivers, in order to support the BACKUP and. FORMAT 
commands. On entry, the DE-registers contain the address of a 14-byte Physical 
Disk Request (PDR) packet. The first byte of the POR packet is an operation 
code which determines the physical operation to be performed. Refer to the disk 
driver interlace specification for details. 




Called with* C = 87 

□ a channel number 

Returns with* A = 0 if comm channel input not available 
A a -1 if comm channel input is available 


Called with* C = 88 

O s channel number 

Returns with* A 3 input character 
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Pinw-Hnw Ontnufr OataCtCC tn Comm Channel 

Called with* C * 89 

O * channel number 

E * output character 

Fwng-Hon 90* S*t Camm rhaniml Baud Rate 

Called withz C * 90 

O » channel number 

E a baud rate codex 

bit 7 a l if attention detection enabled 

bit 6 a 1 jf ciear-to-send handshaking enabled 

hit 5 a 1 if output-only (input disabled) 

bits 3-0 a baud-rate value Q**«15 (see t abl e below) 

Notess The least significant nibble of the E-register contains a baud rate value 

as f allows* 


0 

3 

50 

8 a 

1400 

1 

3 

75 

9 a 

2,000 

2 

3 

110 

10 a 

2,400 

3 

3 

134*5 

11 a 

3,600 

4 

3 

IJO 

12 a 

4,300 

5 

3 

300 

13 a 

7,200 

6 

3 

600 

14 a 

9,600 

7 

3 

1,200 

15 a 

19,200 


Eunction 21& Return, Comm Channel Baud, Rate 

Called withz C a 91 

0 a channel number 

Returns withz A = baud rate code 

Notesz A-register returns a baud rate code as described for function 90. 
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Function 92s. Set Modem. Control* 

Called viths C = 92 

O = channel number 

E 3 modem control vector? 
bit 7 » request-to-send 

bit & * data^terminal-ready 
Function 93? Return Modern Status 

Called withs C - 93 

D - channel number 

Retunte withs A = modem status vector: 

bit 7 - ciear-to-send 
bit 6 = data-set-ready 
hit 5 = data-carrier-detect 
bit 4 =■ ring-indicator 

Function 94* (Reserved) 

Notes? Do Not Use. 

Function 93t (Reserved) 

Notes? Do Not Use. 

Function 96* Set Buffer Parameters 

Called with? C = 96 

D = number of buffers 

E = buffer size (0=128, 1=256, 2=512 w 7=16K) 

Notes? Number of buffers must be at least 2. Buffer size must be at least as 
large as the largest physical disk sector size in use. This function causes all 
buffers to be written out (if necessary) and placed on the free chain. 
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Pwnction 9 lx Rsaun ftuffef Parameter* 

Called with* C a 97 

Returns with* A = memory size (pages, 0*64*0 
H * number of buffers 
L * buffer size (0*128, 1*256, 2*512^, 7*1610 

Function. 3St Activate. DQ-File 

Called witbs C * 98 

DE * FOB address (or 0) 

Returns witbs A * 0 if successful 

-1 if file not found 

Notess Only the first 16 bytes of the FCB are used* The file need not have 
been previously opened* This function causes any currently-active DO-file and 
command line to be stacked, and a new DO-file to be activated* This function 
may be called with DE*0 to cancel ail active and stacked DO-files. 

Function. 99t Diaable/Enafrlc Autoload 

Called witbs C * 99 

E * 0 to disable autoload 
-1 to enable autoload 

Function lQQt Send Command U«m» 

Called witbs C * 100 

DE s buffer address (or 0) 

Notess The first byte of the buffer must contain the command line length, with 
the command line text starting at the second byte of the buffer. This function 
causes any currently-active command line to be stacked, and the new command 
line to be activated. This function may be called with DE=0 to cancel all active 
and stacked command lines. 
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Function IQlt Set/Retum Spool MfldC 


Called with* 


C * 101 

0 at printer assignment (if spool mode = 0) 
queue assignment (if spool mode = 1) 
-1 to leave assignment unchanged 
E a spool modes 

0 to print direct 

1 to print spooled 

2 to print to the console 

bit 7 a 1 for remote, 0 for local 
-1 to leave spool mode unchanged 


Returns' with* A- 

H 

L. 


0 if successful 

-1 if invalid parameters 

current printer or queue assignment 

current spool mode 


Notesx Printer and queue assignments are coded 1*"A", 2*"B , V» r 16= n P". 
Assignment to queue zero causes print files to be left unqueued* Assignment to 
printer zero causes print output to be discarded* Setting the assignment or mode 
causes any currently-open print file to be closed and processed in accordance with 
the previous assignment and mode. If both D~ and E-registers are -1, then this 
function returns the current assignment and mode in the HL-registers. 


Function. 102* Sct/Rctmn..SpOQl Drive 


Called with* C - 102 

E = spool drive (0= n A", 15="P") 


Notesx Setting the spool drive causes any currently-open print file to be closed 
and processed in accordance with the current spool mode. 
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Pmw-rfoit 10t« W/Petnrn Da^Spoot Matte 


Called with* C 
B 

D 

E 


101 

printer (O^A", 1«"B" W L5a"P") 
bit T * 1 for remote, 0 for local 
de- gpo ol queue assignments 
1*"A», 2a"B» w 16*"?* 

0 to set printer offline 

-1 to leave queue assignment unchanged 

de-spool modes 

0 to process print job 

1 to suspend print job 

2 to restart print job from the beginning 

3 to terminate print job 

-l to leave de-spool mode unchanged 


Returns with* A 

H 

L 


* 0 If successful 
-1 if invalid 

a current queue assignment 0_16 
= current de-spool mode (1 If stopped, 0 otherwise) 


Notess If both 0- and E-registers are -1, then this function returns the current 
assignment and mode in the HL-registers. 

Function lfl4t Queue Print, File 


Called withs C = 104 

OE a FCB address 

B a queue (Qa»A", ia«BV-T U="P") plus 
bit 7 a 1 if remote, 0 if local 
bit 6 a l if queued files to be deleted after printing 

Notess Only the first 12 bytes of the FCB (Drive, Name and Type) are used, and 
no validation is performed. 
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Function 119t Scad to-Eterrarfc. 

Called withx C = 119 

DE * message buffer address 


with* A » 0 if successful 

-1 if unsuccessful 


Notes* Do Not Use* 

Eunction UDi Esesii^ fron * tistaask 

Called with* C = 120 

OE s message buffer address 


> ' \ t lx 




* .v/S'Jt.nJf 






.*? ** 


.it: 

Returns withx A * 0 if message received IV .- r< t ^ 

1 if negative acknowiegement received 
-1 if unsuccessful 


Notes* Do Not Use-* 

Euacflon 121i &UaaXtt Vsatazx s *T mgrt 




Called withx C 3 121 

OE 3 length of segment requested 

i r 

Returns withx HL s address of segment 
A 3 0 if successful 

-1 if insufficient memory 

Notess Oo Not Use* 




V ^ * 


.... 
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FtimrEian l??* IWUnwte. U~marv Saywant 

Called with* C * 122 

OE * address of segment 

Notaa Oo Not Use* 

wwfK-rion 1 23i ***** latagBxassaa, Veasmgxk 

Called with* C * X2J 

OE * address of node name 
HL * address of message 

Notes* . Oo Not Use* 

Fnn<rHon 12»t gaceh» IntaeuPfraraei Massage 

Called with* C * 124- 

OE * address of node name 

Returns wttfas HL = address of message 

Notes Oo Not Use. 

Function 12h. netor Promo 

fv*-, ■* , ^ •* • * *><• 

Called witiu C * 125 

DE s delay count (system ticks) or 0 

Notes* Oo Not Use. 
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Function 126s Create Progen 

Called with* C = 126 

OE = address of process entrypoint 
HL s address of process work ares 

Returns with* HL = address of new process descriptor 
A * a it successful 

-1 if insufficient memory 

Notes Do Not Use. 

Function 127t Terminate. Process 

Called withx C = 127 

DE » address of process process descriptor (or 0) 

Notes* Do Not Use. 
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